home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 7 / QRZ Ham Radio Callsign Database - Volume 7.iso / mac / files / sat / msat09.tgz / README-0.6 < prev    next >
Text File  |  1994-09-17  |  7KB  |  193 lines
  1.         MicroSat Ground Station Software for Linux and X-Windows.
  2.  
  3.                                 John Melton
  4.                                 g0orx/n6lyt
  5.                         internet: g0orx@amsat.org
  6.  
  7. This is the third ALPHA release (0.6) of my MicroSat ground station software
  8. for Linux and X-Windows.
  9.  
  10. This software is available by anonymous ftp from:
  11.  
  12.    ftp.ucsd.edu:/hamradio/packet/tcpip/incoming/microsat-0.6.tar.gz
  13.    ftp.funet.fi:/pub/ham/satellite/microsat/microsat-0.6.tar.gz
  14.  
  15. To run this software you must be running a linux kernel that has had the
  16. AX.25 protocol package (from Alan Cox - GW4PTS) added to it. I have also
  17. uploaded this as AX25018.tar.gz, which should be applied to the kernel
  18. version 1.1.12.
  19.  
  20. History
  21.  
  22.      0.4  first ALPHA release
  23.      0.5  second ALPHA release
  24.              Uploading of AX.25 package to funet and ucsd.
  25.              Improved hole list management in xpb.
  26.      0.6  third ALPHA release
  27.              Fixed problem in directory.c not freeing memory.
  28.              Makefile changes.
  29.              Rebuilt and tested using:
  30.                   gcc 2.5.8
  31.                   libc 4.5.24
  32.                   X-386 2.1
  33.                   xview 3.2
  34.                   kernel 1.1.12
  35.                   AX25.018 kermel patches
  36.  
  37.  
  38. Inroduction
  39.  
  40. All the programs are written using the OpenLook toolkit, but should work 
  41. with other X-Windows window managers (i.e. tm).
  42.  
  43. This release consists of the following cwprogramsapplications:
  44.  
  45.        xpb             - broadcast monitor.
  46.        directory       - directory list viewer.
  47.        downloaded      - downloaded file list viewer.
  48.        viewtext        - uncompressed ASCII text file viewer.
  49.        upload          - message upload application.
  50.        message         - message preparation application.
  51.  
  52. Also included are:
  53.  
  54.        lha             - unpack an lhz compressed file.
  55.        unzip           - unpack a PKZIP file.
  56.        xloadimage      - an X-Windows image viewer that has been
  57.                                modified to display EIS images (directly
  58.                                from the .dl file,  and from the extracted
  59.                                file).
  60.  
  61. You should note that this is still ALPHA release software (as is the 
  62. AX.25 package for the kernel),  and I am continuing to develop this 
  63. software.  I believe that is now in a state that others can give me some 
  64. good feedback.
  65.  
  66. The release includes all the source,  and I encourage others to help 
  67. develop this software package.  I would appreciate hearing from anyone 
  68. that is planning to make fixes/changes/enhancements to the software,  so 
  69. that I can try to co-ordinate future releases.
  70.  
  71. Please send e-mail via internet to g0orx@amsat.org
  72.  
  73.  
  74.  
  75. Installing the software
  76. -----------------------
  77.  
  78. From the root directory, extract the software from the tar file.  This 
  79. will install the software in the directory /usr/local.  The directory 
  80. tree will contain the following:
  81.  
  82.        microsat/bin
  83.        microsat/src
  84.        microsat/pacsat
  85.        microsat/kitsat-a
  86.  
  87. Add /usr/local/microsat/bin to your PATH.
  88.  
  89. Create a directory for each satellite that you are going to work,  and 
  90. create a start script in each.  There are samples for pacsat and kitsat-
  91. a.  The start script sets up two environment variables,  MYCALL and 
  92. SATELLITE.  These specify your callsign and the callsign of the satellite 
  93. without any suffix.  The start script also starts up xpb, upload, 
  94. directory and downloaded.
  95.  
  96. Running the software
  97. --------------------
  98.  
  99. Setup your TNC in KISS mode for the satellite,  change directory to the 
  100. one created for the satellite,  and run the start script. Four windows 
  101. shoudl appear.
  102.  
  103. xpb:
  104.  
  105.        This program collects the broadcast data from the satellite.
  106.        You can click on the 'Directory Fill' button to send a request
  107.        to the satellite to get your directory updated.  You can enter
  108.        a file id (currently lowercase 'a'..'f'), and then click on the
  109.        'File Fill' button to send a request to the satellite to fill
  110.        or send a file.
  111.  
  112. directory:
  113.  
  114.        This program displays the collected directory.
  115.  
  116.        The 'Update' button lets you update the listbox with the latest
  117.        directory entries received by xpb (note that there is no automatic
  118.        update of this list as new directory entries are received).
  119.  
  120.        The 'Fill Directory' buuton will send a request to xpb to
  121.        transmit a request to the satellite to fill the holes in your
  122.        directory.
  123.  
  124.        The 'Fill File' button will send a request to xpb to transmit
  125.        a hole fill (or file send) request to the satellite for the
  126.        currently selected file in the listbox.
  127.  
  128.        The 'View' menu lets you display all the directory entries (All), 
  129.        mail to or from you (My Mail) or broadcast messages (Broadcast)
  130.        that have All as their destination.
  131.  
  132. downloaded:
  133.  
  134.        This program displays a list of downloaded files in a similar
  135.        manner to the directory program.
  136.  
  137.        The 'Update' button lets you update the listbox with the latest
  138.        downloaded files received by xpb (note that there is no automatic
  139.        update of this list as new files are received).
  140.  
  141.        The 'Extract' button will extract the currently selected file
  142.        in the listbox into a subdirectory called msgs.
  143.  
  144.        The 'View File' button will try to display the currently selected
  145.        file.  This only works if the file is an uncompressed ASCII
  146.        file, or an EIS image.
  147.  
  148.        The 'Reply' button will startup a copy of the message program
  149.        (see below),  but will fill in the destination,  and the title
  150.        based on the currently selected message.
  151.  
  152.        The 'View' menu lets you display all the downloaded file (All), 
  153.        mail to or from you (My Mail) or broadcast messages (Broadcast)
  154.        that have All as their destination.
  155.  
  156. upload:
  157.  
  158.        This program displays a list of messages that have been prepared
  159.        for uploading using message (see below).
  160.  
  161.        The 'Update' button will update the list of files prepared for
  162.        uploading.
  163.  
  164.        The 'Message' button will bring up the message preparation program
  165.        with only the source field filled in.
  166.  
  167.        The 'Upload' button will try to connect to the satellite and
  168.        upload the file.
  169.  
  170.        Note that the initial message Id will be 0,  but will change to 
  171.        the
  172.        actual imessage Id once the upload request has been accepted by 
  173.        the
  174.        satellite.  This will be used if a message is not completely 
  175.        uploaded
  176.        in one session,  so that it can be continued on another pass.
  177.  
  178.        The Status message will show the current state of the upload.
  179.  
  180. message:
  181.  
  182.        This program is for preparing a message for uploading to the 
  183.        satellite.  For simple text messages (uncompressed) there is
  184.        an edit window that allows you to enter the text (limit of 2K).
  185.  
  186.        If you want to prepare a message that is a file,  you should
  187.        click on the 'File' selection,  and then type in the full
  188.        path of the file in the message text area.
  189.  
  190.        Clicking on the 'Prepare' button will create the .upl file.  To
  191.        see this in the upload listbox,  you must click on the 'Update'
  192.        button in the upload window.
  193.